home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / diags.zip / DIAGS.DOC next >
Text File  |  1986-04-28  |  18KB  |  395 lines
  1.                                    DIAGS.EXE
  2.       
  3.           Special Serial, Parallel, Video diagnostics for the PC
  4.   
  5.           Written by Joan Riff for: 
  6.       
  7.           Computerwise Consulting Services 
  8.           P.O. Box 813, McLean, VA 22101 
  9.           (703) 280-2809 
  10.       
  11.       
  12.      Introduction
  13.      ____________
  14.       
  15.      DIAGS is a tool for the advanced PC user, period. It is NOT for the
  16.      general public. This manual will not explain things in elementary terms.
  17.      If you know what a 6845 is, and what an 8250 is, and what parallel
  18.      handshaking lines are, then DIAGS will be extremely useful to you. If
  19.      not, then you may have better things to do with your time than try to
  20.      figure out this program. 
  21.       
  22.      DIAGS started out as a testbed for our new interrupt-driven RS232
  23.      libraries. The Serial Port Diagnostics were the first written, to test
  24.      the Microsoft version 3.0 'C' interface to these routines. 
  25.       
  26.      It has since grown. As we have added more assembler routines to our
  27.      library, we have added corresponding DIAGS functions to test them.
  28.       
  29.      Additionally, DIAGS has been expanded as we experienced the need for new
  30.      diagnostics capabilities. So the Parallel Port diagnostics were added
  31.      when we had to debug yet another unknown printer's handshaking. And the
  32.      6845 diagnostics were added when we needed to test various video tricks
  33.      like displaying 30 lines of text, smooth scrolling, etc. 
  34.       
  35.      As it now stands, DIAGS is a very powerful facility for: 
  36.       
  37.           1) Testing all sorts of asynch communications lines 
  38.       
  39.           2) Testing printer handshaking and cable wiring 
  40.       
  41.           3) Examining an unknown system's DOS environment, including:
  42.  
  43.                a) Interrupt vectors 
  44.                b) Resident device handlers 
  45.       
  46.           4) Directly manipulating the 6845. 
  47.      Main Menu
  48.      _________
  49.  
  50.      The main DIAGS menu displays information about the machine and about
  51.      DOS, and presents a list of the various diagnostics that are available.
  52.      When you exit a particular diagnostic, you are returned to this main
  53.      menu.
  54.  
  55.  
  56.      (D)isk Info
  57.      ___________
  58.       
  59.      Let's describe the weakest and least important diagnostic first.
  60.       
  61.      The DISK INFO selection from the main menu displays just about every-
  62.      thing that can be determined about a disk. Make sure that you have a
  63.      diskette in the indicated drive before selecting this option. 
  64.       
  65.      Since there are other utilities which do just about everything that you
  66.      may want to do with a disk, we haven't done much with this diagnostic.
  67.      We just display disk information as reported by DOS as well as by the
  68.      disk's Boot Record. 
  69.       
  70.      Once in the Disk Info screen, the following keypresses are available to
  71.      you: 
  72.       
  73.           ESC - return to the main DIAGS menu
  74.  
  75.           ALT-V - verify a diskette by reading every sector via DOS INT
  76.           025h. This is SLOW!!!! Think of this as a demo of just how
  77.           slow INT 025h can be. 
  78.       
  79.           ALT-R - reset drive. Doesn't do much, huh? That's what we
  80.           wanted to see. 
  81.  
  82.           A thru Z - select new drive for which statistics are to be
  83.           displayed. Again, be sure that you have a disk in whatever
  84.           drive you select. 
  85.       
  86.      That's it. Not much to it. If you need to do more, then use: 
  87.       
  88.           The Norton Utilities 
  89.           Quaid's Disk Explorer 
  90.           Central Point Software's Option Board 
  91.      (I)nterrupt Vector Display
  92.      __________________________
  93.       
  94.      This selection from the main menu displays the system's Interrupt
  95.      Vectors. For each interrupt, the following information is displayed:
  96.       
  97.           The interrupt number 
  98.           The interrupt vector's address within segment zero 
  99.           The Segment:Offset of its handler 
  100.           The interrupt's name and/or use 
  101.       
  102.      If an interrupt points to an IRET, then that fact is reported by a
  103.      highlighted "[IRET]" displayed after the name.
  104.  
  105.       
  106.      Once in the Interrupt screen, the following keypresses are available to
  107.      you: 
  108.       
  109.           ESC - exit back to main menu
  110.           Home - scroll display back to Interrupt 0
  111.           End - scroll display to the end of the interrupts (F0 thru FF)
  112.           PgDn - scroll to the next page of vectors
  113.           PgUp - scroll up to the previous page of vectors
  114.           Up Arrow - scroll up 1 line
  115.           Down Arrow - scroll down 1 line
  116.       
  117.  
  118.  
  119.      (P)arallel Diagnostics
  120.      ______________________
  121.       
  122.      This is a more complicated set of diagnostics. It allows you to do all
  123.      sorts of useful things with the parallel ports. We use these routines
  124.      when we're trying to figure out whether or not some new printer is
  125.      working properly with the system. 
  126.       
  127.      At the top of the screen is displayed: 
  128.       
  129.           The number of parallel ports on the system (1 thru 4) 
  130.           The number of the currently-selected printer (0 thru 3) 
  131.           The base I/O address of the currently-selected printer 
  132.           The trip character that is currently set (see below) 
  133.           Whether interrupts are allowed or disallowed during sampling
  134.       
  135.      The Parallel Port Diagnostics menu gives you the following choices:
  136.       
  137.           (I)nit printer - does a ROM BIOS "init printer" call.
  138.       
  139.           (E)nable Interrupts during sampling - toggles the indicator on
  140.           the top line, which indicates whether INTs are to be dis-
  141.           allowed during sampling. 
  142.       
  143.           (N)ew Trip character - allows you to specify a new character
  144.           to be sent to the printer to 'trip' it. This is initially a
  145.           Linefeed. 
  146.           (P)rinter switch - selects next printer (in sequence) as the
  147.           current printer. 
  148.       
  149.           (T)rip printer - sends the current Trip character to the
  150.           printer, and then captures the printer Status port lines using
  151.           a special high-speed capture routine. These lines are dis-
  152.           played in oscilloscope format, allowing you to see at a glance
  153.           the operation of the BUSY line, ACK line, etc. Interrupts will
  154.           be inhibited during the sampling if the top line of the
  155.           display shows "No Ints". Press ESC to exit from the display of
  156.           the status lines. 
  157.       
  158.           (U)nique Printer setup - sends custom codes to set various
  159.           specific printers into various modes. The printers currently
  160.           supported are: 
  161.       
  162.                Data Products 8070 (and perhaps IDS Color Prism) 
  163.                IBM Graphics Printer (and certain Epsons) 
  164.                Fujitsu DL-2600 (and perhaps Epson JX color series) 
  165.                Okidata Microline 93 
  166.                Diable 630 (and C.ITOH Starwriter, F-10, etc) 
  167.                C.ITOH Prowriter 
  168.       
  169.           Follow the prompts that are displayed when you make this
  170.           selection. 
  171.       
  172.           (Q)uit parallel diagnostics - to return to main menu
  173.       
  174.           The following three selections are invaluable for checking
  175.           proper printer cabling and handshaking: 
  176.       
  177.           (D)ata lines - displays the parallel port Data I/O port lines
  178.           in oscilloscope-like format. Press ESC to exit the oscillo-
  179.           scope display. 
  180.       
  181.           (S)tatus lines - as above, but lines displayed are from
  182.           the parallel Status I/O port. 
  183.       
  184.           (C)ontrol lines - as above, but lines displayed are from
  185.           parallel Control I/O port. 
  186.       
  187.           The following selections send various strings to the printer: 
  188.       
  189.           (F)ox message - sends a continuous FOX message to the printer
  190.           via direct I/O (bypassing the ROM BIOS). Press ESC to stop it.
  191.       
  192.           (A)scii character set - sends the complete ASCII character set
  193.           to the printer via direct I/O (bypassing the ROM BIOS). No
  194.